home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / prune22.zip / PRUNE.DOC < prev    next >
Text File  |  1992-03-31  |  4KB  |  85 lines
  1. Program Name:   PRUNE   (PRUNE.EXE)
  2.  
  3. Version:        2.1   September, 1990
  4.  
  5. Function:       Clear out unallocated bytes at the end of a file.
  6.  
  7. Requirements:   64K, DOS 2.0 or later.
  8.  
  9. Command Syntax: prune filespec...filespec
  10.                 prune /s filespec...
  11.                 prune /f "fill value" filespec...
  12.                 prune /u filespec...
  13.  
  14.                 "filespec" may contain drive and path specifiers, as well
  15.                 as wildcards (* and ?). If the "/s" option is given, all
  16.                 subdirectories will be searched for matching files.  The
  17.                 fill value is normally 1A hex, but can be set to anything
  18.                 by the "/f" option.  The "/u" option causes all unallocated
  19.                 file space to be filled in addition to the file ends.
  20.  
  21. Discussion:
  22.  
  23.     DOS allocates disk space in terms of fixed-length "chunks" called
  24.     clusters.  Few files are exactly a multiple of the cluster size in
  25.     length, so the unused bytes at the end of the last cluster may
  26.     contain sensitive information left in the memory of the system used
  27.     to generate or copy the files.  PRUNE over-writes the unused bytes
  28.     with the DOS end-of-file character, hex 1A, or whatever was specified
  29.     if the "/f" option was used.  The sizes of the files thus processed
  30.     are not affected by this operation.  File times and dates are preserved.
  31.  
  32.     Non-printing values can be specified for /f by preceding the decimal
  33.     value of each character with a backslash.  Thus, an ASCII line feed
  34.     can be specified by \010.  A fill character having the value of the
  35.     backslash can be specified either by two consective backslashes, or
  36.     by the sequence \92.
  37.  
  38.     If the "/u" option is specified, all unallocated storage is cleared to
  39.     heaxdecimal "F6".
  40.  
  41.     Standard DOS I/O is used, so PRUNE should work on any disk, including
  42.     RAMDisk.
  43.  
  44. Examples:
  45.  
  46.         PRUNE /F "EMPTY SPACE " /S C:\*.* D:\*.*
  47.  
  48.         All files on drives C: and D: are PRUNE-d, the fill pattern used is
  49.         "EMPTY SPACE ".
  50.  
  51.         PRUNE /S D:\DUMMY\*.EXE
  52.  
  53.         All .EXE files in the subdirectory "DUMMY" and any of its subdirec-
  54.         tories are pruned, using the value 1A hex.
  55.  
  56.         PRUNE /U /S /F \00 \*.*
  57.  
  58.         All files on the current drive are PRUNE-ed with a fill pattern of
  59.         nulls.  Unallocated file space is filled with hex F6.
  60.  
  61.                       Copyright 1989, 1990, 1992 by
  62.  
  63.                                Sydex
  64.                            P.O. Box 5700
  65.                           Eugene, OR  97405
  66.                         (503) 683-6033 (voice)
  67.                         (503) 683-1622 (FAX)
  68.  
  69.                          All rights reserved.
  70.  
  71.     NOTICE: This product is supplied "as-is".  No warranties of any
  72.     kind are given by Sydex, nor will Sydex be held liable for any
  73.     damage, either accidental or intentional, resulting from the use
  74.     of this or any other program.
  75.  
  76.     Sydex hereby grants license to freely reproduce and redistribute this
  77.     program, provided that no fee is charged for the program.  A small fee,
  78.     not to exceed $10 may be charged to cover the costs of reproduction and
  79.     distribution of this program.  This program and its documentation may
  80.     not be altered or modified in any way.
  81.  
  82.     Any other use or application of PRUNE or its documentation constitutes
  83.     a violation of copyright and may be subject to criminal and/or civil
  84.     prosecution.
  85.